Result Test

The Result Test window is used to add or edit a result test for any script item. Result Tests allow you to set an item to install based on the result of a previous script item, like a Find or Message item.

This Result Test window is opened by clicking the New or Edit buttons inside the Result view within an item's info window. See the attributes section of this guide for more details.

The Result Test window contains the following items:

Result Test

This popup menu allows you to select either a predefined Gestalt Test or a custom one. If one of the predefined tests is chosen (see the list below), then the remaining fields in the window are filled and set inactive so that they cannot be changed. If "Custom" is selected, then you can define you own Result Test in the fields below.

• "Last Find Was Successful" only installs the script item if the last Find item was successful in its search.
• "Last Find Was Not Successful" only installs the script item if the last Find item was not successful in its search.
• "Last Message Answered Yes" only installs the script item if the last Message item was answered "Yes".
• "Last Message Answered No" only installs the script item if the last Message item was answered "No".

Signature

This entry field represents a four-letter result signature. For the predefined tests, the signature field is automatically filled in. For custom tests, you must enter the four letter signature for the test you want to perform. A result signature names an area of memory where the result of a script item is stored. These result values can be checked by other script items. In this respect, result signatures are similar to variables.

Two of DragInstall script items currently set results which can be tested. The Message item sets the signature 'mess' by default (although this can be changed), and the Find item sets the signature 'find'. The signatures 'mess' and 'find' have been reserved as the standard signatures for Message and Find items. In the future, we will continue to choose signatures with all lower case characters for our results. To prevent future conflicts, do not use signatures with all lower case characters.

Operator

This radio set shows comparison operators available for the Result Test. When you choose a predefined Result Test (i.e. "Last Find Was Successful") the operator is set for you. For custom Result Tests, you will need to choose the operator appropriate to your needs. The choices for operator include "is equal to" and "is not equal to".

Value

This entry field allows you to specify a comparison value for the Result Test.

Change

This button closes the window, saving any changes. For a new Result Test, this button is named Create.

Cancel

This button closes the window, canceling any changes.

Delete

This button deletes the current Result Test from the script item. For a new Result Test, this button is not available.

[Contents | Contact Information]